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With the support of NASA’s Astrophysics Data Program (NRA 92-OSSA- 15), we have developed 
the Astronomical Software Directory Service (ASDS): a distributed, searchable, WWW-based database of 
software packages and their related documentation. ASDS provides integrated access to 56 astronomical 
software packages, with more than 16,000 URLs indexed for full-text searching. Users are performing about 
400 searches per month. A new aspect of our service is the inclusion of telescope and instrumentation 
manuals, which prompted us to change the name to the Astronomical Software and Documentation Service. 
We have already incorporated 68 on-line manuals from 23 sites, with about 6500 URLs indexed for searching. 
Our home page, shown in Figure 1, is available on the WWW at http://asds.stsci.edu/asds/. 

ASDS was originally conceived to serve two purposes: to provide a useful Internet service in an area of 
expertise of the investigators (astronomical software), and as a research project to investigate various archi- 
tectures for searching through a set of documents distributed across the Internet. Two of the co-investigators 
were then installing and maintaining astronomical software as their primary job responsibility. We felt that 
a service which incorporated our experience in this area would be more useful than a straightforward listing 
of software packages. The original concept was for a service based on the client/server model, which would 
function as a directory/referral service rather than as an archive. This concept predated the emergence of 
the World Wide Web (WWW). Once we the WWW came into existence, we quickly settled on the idea of a 
Web site devoted to searching through documents associated with astronomical software. 

Our original concept of how our site would be used was that astronomers, or astronomical programmers, 
having some idea of what they needed in the way of astronomical software, would perform full text searches 
of our document collection, with the idea that relevant documents would come from packages deserving 
the user’s attention. Once interesting packages had been identified, users could then go to our package 
descriptions to find out how to get the packages, what resources were required to run them, and perhaps 
what our experience was when we installed them. We created a standardized template for describing the 
software packages, with fields describing many of the general features of each package, ensuring that each 
package in our collection had a “package description” Web page. The other documents in our collection 
include user guides, programmer guides, on-line help files, UNIX man pages, and custom Web interfaces 
to software documentation — basically, anything available on-line in HTML format, or some other format 
suitable for full-text searches. But rather than collecting all of these documents into a centralized archive 
that we maintain, we chose to index the documents maintained by their authors. The results of a search 
include links to the original documents, so that users retrieve documents from the host sites. This insures 
that users always get the most up-to-date documentation. 

For performing the searches, we began our investigation with a decision to evaluate the Isite software 
from the Center for Networked Information Discovery and Retrieval (CNIDR). This software was intended as 
a replacement for WAIS (Wide-Area Information Service), a client/server technology for performing full-text 
searches through a set of documents. Isite had some additional features that we considered attractive, and we 
enjoyed the cooperation of the Isite developers, who were happy to have ASDS as a demonstration project. 
We ended up staying with the software throughout the project, making modifications to take advantage of 
new features as they came along, as well as influencing the software development. The Web interface to the 
search engine is provided by a gateway program written in C++ by a consultant to the project (A. Wamock). 

The key modification to the Isite software that made it applicable to our project was allowing it to open 
a WWW URL for indexing and searching — the original software, like WAIS, could only handle files in 
the host’s own file system. Most of what made ASDS a research project had to do with the way in which 
this modification was implemented. The original version of Isite did not store information in the index if it 
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Astronomical Software 
& Documentation Service 

Welcome to ASDS, a collection of on-line astronomical documents 
indexed for full-text searching. 

The software collection is made up of: 
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\ZZ& Packages: Packages have a description page, outlining their 
capabilities, requirements, and availability. Search them for general 
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mm Documents: The document collection consists of user 
guides, programmer guides, on-line help files, etc., made available by the 
software providers. Search the document collection to find more detailed 
requirements. Search results are linked to the associated package 
description. (Not all packages have associated documents). 

The telescope manuals collection newt consists of 


YS3 Sites: E ach site has a description page, with links to more 
information, and thumbnail sketches of each manual in the collection. 
Search the site descriptions for general information. 

SB Manuals: Telescope manuals, intrumentation manuals, and 
user guides, indexed for searching. Search the manuals collection for 
p articular requirements . 




Figure 1 : The ASDS home page. 
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could be retrieved at search time from the documents themselves. Similarly, the original implementation of 
indexing URLs required the search engine to go out on the Internet at search time to retrieve the information 
not stored in the index. This made our system similar to those systems that query distributed servers by 
sending a query to each one, and collecting the results as they come back, i.e., slow. If remote systems were 
down, or if a software author changed a document, then searches would fail. In subsequent iterations, more 
information has been in the index, eliminating network traffic at search time. The current system is robust 
against changes in the documents, although the index is updated regularly to track authors’ changes. 

At the end of the project, we have package descriptions for 56 packages, grouped into seven functional 
categories: 

• Data reduction and analysis, 

• Document preparation, 

• Graphics, plotting, image display, and visualization, 

• Modelling and simulation, 

• Math and statistics, 

• Subroutine libraries, and 

• Utility programs. 

Of these 56 packages, 41 have an associated searchable index of on-line documents. A total of 16,000 URLs 
have been indexed. It takes the search engine less than a second to perform a simple search of all 16,000 
documents. Through the Web interface, the search time is completely dominated by the time it takes for the 
user to transmit the query to us, and for us to transmit the results back to the user. 

Most of the effort invested in ASDS has been devoted to three areas. First, as with most projects dating 
back to the start of the Web, we did a lot of experimenting with user interface issues: arranging the content, 
navigating the site, establishing convenient links between document searches and the corresponding package 
descriptions, and establishing a balance between searching and browsing. One of the last tasks on this 
project was giving the site a finished look and feel. The second major effort was in automating our Web site 
maintenance. Almost all of the Web pages from our site are generated by Perl scripts, either on-the-fly for 
each user, or saved periodically into static pages as part of routine maintenance. After a new package or 
document has been added to our collection, the entire Web site can be rebuilt with a simple UNIX “make” 
command. These two aspects of the project have been quite successful, and will have continued benefits in 
allowing ASDS to be maintained at relatively low cost after the end of the project, and in future Web services 
being developed by the investigators. The third major task was adding content to the system: searching 
the Web for software, searching through Web sites for the information required to complete a package 
description page, and collecting URLs of pages to be indexed. 

We recently extended the ASDS architecture to the subject of telescope manuals, extending the pack- 
age description/software manuals paradigm to a site description/telescope manuals paradigm, as part of a 
project to index more of the astronomical grey literature. This project will produce Web forms to facilitate 
maintenance of the ASDS Web site, reducing the cost of adding new content. 

The ASDS remains available, and will continue to be available as resources allow. We plan to continue 
to add packages and manuals, and to respond to updates in the Isite software. We are considering options 
for further enhancing the service, and broadening its scope, via other funding sources. 
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